Content AI

Overview

Description: The Content Generation API leverages AI (LLMs) to create or transform text content. This is useful for generating product descriptions, marketing copy, blog content, or transforming existing text (e.g., summarizing, reformatting, translating, or changing tone). Outter’s Content Generation Service handles these requests, optionally utilizing external AI providers like OpenAI, Anthropic, Mistral or local models, depending on configuration.

Whether you're looking to create engaging product descriptions, refine marketing copy, translate content, or generate structured outputs, Outter provides a powerful, flexible API to meet your needs.

You can use Outter Content AI to

• Text Generation – Generate new content from a prompt (e.g., product descriptions, blog content).
• Summarization – Summarize longer text into key points or a shorter summary.
• Translation – Translate text from one language to another.
• Reformatting – Convert text from one format to another (e.g., turn a raw list of facts into a formatted paragraph).

Endpoints:

• POST /api/v2/ai/content/generate – create new content based on a prompt or parameters.
• POST /api/v2/ai/content/transform – modify or transform existing content (e.g., summarize text, translate, or change style).

Generating Content (Product Description)

A request to generate an engaging product description for an e-commerce catalog using Claude-3.5-Sonnet:

POST /api/v2/ai/content/generate
Content-Type: application/json
Authorization: X-API-Key YOUR_API_KEY

{
  "model": "claude-3-7-sonnet-20250219",
  "prompt": "Product: Aurora Smart Desk Lamp Features: Dimmable LED, touch control, wireless charging, adjustable color temperature. Write a compelling product description with an emphasis on modern design and usability.",
  "max_length": 200,
  "tone": "modern, engaging",
  "language": "en"
}

Response:

{
  "content": "Illuminate your workspace with the **Aurora Smart Desk Lamp**—a fusion of modern design and next-gen technology. Featuring **dimmable LED lighting**, intuitive **touch controls**, and **adjustable color temperatures**, Aurora adapts to your needs whether you're working late or winding down. Plus, the **built-in wireless charging pad** keeps your devices powered up effortlessly. Redefine your workspace with smart, stylish lighting.",
  "usage": {
    "model": "claude-3-7-sonnet-20250219",
    "tokens_input": 45,
    "tokens_output": 112,
    "cost": 0.004
  },
  "request_id": "req-987654"
}

Key Parameters

• model – Specify the AI model (e.g., claude-3-7-sonnet-20250219, gpt-4o, mistral-7b-instruct-v0.3).
• prompt – Defines the task; well-structured prompts improve output quality.
• tone – Controls style; options include formal, casual, persuasive, playful, etc.
• max_length – Limits the output’s size in tokens.
• language – Specifies output language (e.g., en, fr, de).

---

Summarization

A request to summarize a customer service report using Outter proprietary model olivaw-c3:

POST /api/v2/ai/content/transform
Content-Type: application/json
Authorization: X-API-Key YOUR_API_KEY

{
  "model": "llama-3.3-70B-instruct",
  "action": "summarize",
  "text": "The customer reported intermittent connection issues with their Wi-Fi router over the past week. The support team identified outdated firmware as the cause. After updating the firmware and rebooting the device, the issue was resolved. The customer confirmed a stable connection afterward and rated the support experience as excellent.",
  "target_length": "short"
}

Response:

{
  "original_length": 54,
  "transformed_text": "The customer had Wi-Fi issues due to outdated firmware. A firmware update resolved the problem, and they reported stable connectivity afterward.",
  "usage": {
    "model": "olivaw-c3",
    "tokens_input": 35,
    "tokens_output": 22
  },
  "request_id": "req-654321"
}

---

Reformatting Text (Bullet Points to Narrative)

A request to convert a raw list into a smooth, readable paragraph using OpenAI GPT-4o:

POST /api/v2/ai/content/transform
Content-Type: application/json
Authorization: X-API-Key YOUR_API_KEY

{
  "model": "GPT-4o",
  "action": "reformat",
  "text": "- High-quality stainless steel blade- Ergonomic, non-slip handle\- Dishwasher-safe- Comes with a protective sheath- Designed for precision cutting",
  "format": "paragraph"
}

Response:

{
  "original_format": "bullet_points",
  "transformed_text": "This premium knife features a **high-quality stainless steel blade** designed for precision cutting. The **ergonomic, non-slip handle** ensures a secure grip, making it comfortable for extended use. It’s **dishwasher-safe** for easy maintenance and comes with a **protective sheath** for safe storage.",
  "usage": {
    "model": "GPT-4o",
    "tokens_input": 28,
    "tokens_output": 58
  },
  "request_id": "req-789012"
}

Translating Content (English to Spanish)

A request to translate a marketing tagline from English to Spanish using Mistral-7b-Instruct:

POST /api/v2/ai/content/transform
Content-Type: application/json
Authorization: X-API-Key YOUR_API_KEY

{
  "model": "mistral-7b-instruct-v0.3",
  "action": "translate",
  "text": "Experience the future of smart home technology.",
  "source_language": "en",
  "target_language": "es"
}

Response:

{
  "original_text": "Experience Coldplay live as they bring their Music of the Spheres World Tour to Madison Square Garden! Join us for an unforgettable night filled with iconic hits, mesmerizing visuals, and an electrifying atmosphere. Get ready to sing along to classics like Yellow, Viva La Vida, Fix You, and their latest chart-toppers.",
  "translated_text": "¡Vive la emoción de Coldplay en vivo en su Gira Mundial Music of the Spheres en Madison Square Garden! Prepárate para una noche inolvidable llena de éxitos icónicos, efectos visuales sorprendentes y una atmósfera electrizante. Canta junto a ellos temas legendarios como Yellow, Viva La Vida, Fix You, y sus últimos éxitos.",
  "usage": {
    "model": "Mistral-7b-Instruct",
    "tokens_input": 124,
    "tokens_output": 136    
  },
  "request_id": "req-543210"
}

---

Best Practices & Notes

• Use well-structured prompts – The more context you provide, the better the AI output.
• Optimize for token efficiency – Reduce unnecessary words in prompts to minimize cost.
• Leverage model strengths – Different models excel at different tasks (e.g., GPT-4o for creative writing, Mistral for concise answers).
• Fine-tune tone and format – Match content to your brand’s voice by specifying style preferences.
• Monitor API usage – Check the tokens_used to track API consumption.

---